home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmRepTypeRegister.z / XmRepTypeRegister
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr - A representation type manager function
  10.           that registers a representation type resource
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/RepType.h>
  14.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeIIIIdddd XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr(
  15.           SSSSttttrrrriiiinnnngggg rrrreeeepppp____ttttyyyyppppeeee,
  16.           SSSSttttrrrriiiinnnngggg ****vvvvaaaalllluuuueeee____nnnnaaaammmmeeeessss,
  17.           uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****vvvvaaaalllluuuueeeessss,
  18.           uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr nnnnuuuummmm____vvvvaaaalllluuuueeeessss);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr registers a representation type resource
  25.           with the representation type manager. All features of the
  26.           representation type management facility become available for
  27.           the specified representation type. The function installs a
  28.           forward type converter to convert string values to numerical
  29.           representation type values.
  30.  
  31.           When the _v_a_l_u_e_s argument is NULL, consecutive numerical
  32.           values are assumed. The order of the strings in the
  33.           _v_a_l_u_e__n_a_m_e_sarray determines the numerical values for the
  34.           resource. For example, the first value name is 0 (zero); the
  35.           second value name is 1; and so on.
  36.  
  37.           If it is non-NULL, the _v_a_l_u_e_s argument can be used to assign
  38.           values to representation types that have nonconsecutive
  39.           values or have duplicate names for the same value.
  40.           Representation types registered in this manner will consume
  41.           additional storage and will be slightly slower than
  42.           representation types with consecutive values.
  43.  
  44.           A representation type can only be registered once; if the
  45.           same representation type name is registered more than once,
  46.           the behavior is undefined.
  47.  
  48.           The function XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeAAAAddddddddRRRReeeevvvveeeerrrrsssseeee installs a reverse
  49.           converter for a registered representation type. The reverse
  50.           converter takes a representation type numerical value and
  51.           returns the corresponding string value. If the list of
  52.           numerical values for a representation type contains
  53.           duplicate values, the reverse converter uses the first name
  54.           in the _v_a_l_u_e__n_a_m_e_s list that matches the specified numeric
  55.           value. For example, if a _v_a_l_u_e__n_a_m_e_s array has _c_a_n_c_e_l,
  56.           _p_r_o_c_e_e_d, and _a_b_o_r_t, and the corresponding _v_a_l_u_e_s array
  57.           contains 0, 1, and 0, the reverse converter will return
  58.           _c_a_n_c_e_linstead of _a_b_o_r_t for an input value of 0.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _r_e_p__t_y_p_e  Specifies the representation type name.
  75.  
  76.           _v_a_l_u_e__n_a_m_e_s
  77.                     Specifies a pointer to an array of value names
  78.                     associated with the representation type. A value
  79.                     name is specified in lowercase characters without
  80.                     an XXXXmmmm prefix. Words within a name are separated
  81.                     with underscores.
  82.  
  83.           _v_a_l_u_e_s    Specifies a pointer to an array of values
  84.                     associated with the representation type. A value
  85.                     in this array is associated with the value name in
  86.                     the corresponding position of the
  87.                     _v_a_l_u_e__n_a_m_e_sarray.
  88.  
  89.           _n_u_m__v_a_l_u_e_s
  90.                     Specifies the number of entries in the _v_a_l_u_e__n_a_m_e_s
  91.                     and _v_a_l_u_e_s arrays.
  92.  
  93.      RRRREEEETTTTUUUURRRRNNNN
  94.           Returns the identification number for the specified
  95.           representation type.
  96.  
  97.      RRRREEEELLLLAAAATTTTEEEEDDDD
  98.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeAAAAddddddddRRRReeeevvvveeeerrrrsssseeee(3), XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttIIIIdddd(3),
  99.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttNNNNaaaammmmeeeeLLLLiiiisssstttt(3), XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttRRRReeeeccccoooorrrrdddd(3),
  100.           XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeGGGGeeeettttRRRReeeeggggiiiisssstttteeeerrrreeeedddd(3), and XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeVVVVaaaalllliiiiddddVVVVaaaalllluuuueeee(3).
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.